Developer Documentation

QuickTime 4 API Documentation

Wired Movies and Sprites

| Previous | Chapter Contents | Chapter Top | Next |

Action Constants

Each individual action in an action list is contained by an atom of type kActionAtom . Its child atoms define which action it is, what target in the movie it operates on, what the values of each of its parameters are, and any parameter options for each parameter.

Since each action is intended to be sent to a particular type of target, the action constants are explained below, grouped by their target type.

If minimum and maximum values are not specified, then they may be assumed to be the full range of the parameter's data type.

Constant descriptions

kAction
This atom is a container for a single sprite action. Add an atom of this type for each action in an action list. The list of actions will be executed in order, based on the index of these atoms, from one to the number of kAction atoms present. The IDs may be any unique IDs. This atom's parent type is commonly kQTEventType . It may also be a child atom of a kQTEventFrameLoaded atom, and of a kActionListAtomType atom for nested action lists.

kWhichAction
This atom specifies the type of action that will be executed. Add a child atom of this type to each kAction atom, setting its ID to 1. The atom's leaf data is a long which contains the constant describing which action to execute. For example, to create a set movie volume action, set the leaf data of the kWhichAction atom to kActionMovieSetVolume .

kCommentAtomType
This atom allows you to comment an action or an event in a language independent manner. Tools which decompile action lists may choose to display these comments. You may add any number of comments to each action or event. The order is defined by the atom index.

The parent atom type of the kCommentAtomType is either kAction , kQTEventType , or kQTEventFrameLoaded . The leaf data is a C string.

Movie Action Constants

Actions for All Tracks  


© 1999 Apple Computer, Inc.

| Previous | Chapter Contents | Chapter Top | Next |